home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: The RISC OS Graphics CD / Acorn User: The RISC OS Graphics CD.iso / argonet / thumbnail.spk / !Thumbnail / !Help < prev    next >
Text File  |  1997-08-03  |  35KB  |  831 lines

  1.  
  2.  
  3.            Thumbnail           © copyright, Ian Palmer 1994, 1995, 1996, 1997
  4.            =========
  5.  
  6.  
  7. IMPORTANT
  8. =========
  9.  
  10. Thumbnail is now FREEWARE.
  11.  
  12.  
  13.  
  14. Introduction
  15. ------------
  16.           
  17. Thumbnail provides you with a convenient way of searching for a picture from a
  18. library of pictures by providing 'Thumbnail' versions of the pictures that
  19. can be viewed quickly and easily.
  20.  
  21. Thumbnail requires Acorn's ChangeFSI application as it uses this for
  22. converting different file formats to a convenient format.
  23.  
  24. Thumbnail also provides support for producing thumbnails of Draw and Artworks
  25. files. Thus it can provide a very convenient way of looking at clipart for
  26. the Draw/Artworks files you want without having to load all the draw files
  27. into !Draw, !ArtWorks or !AWViewer. Now Thumbnail also provides support for
  28. Replay files.
  29.  
  30. Thumbnail maintains thumbnail versions of pictures and draw files within a
  31. directory structure, complete with descriptions and details of where the
  32. original file is located, so you can easily access the original file directly
  33. from thumbnail. All Thumbnail pictures are stored at 16bpp (or 32 bpp) and
  34. dithered to either 256 colour or 16 colour when needed for display.
  35.  
  36. Thumbnail can be run from either hard disc or floppy, although hard disc is
  37. better speedwise. Because Thumbnail allows you to store the original pictures
  38. separately from the thumbnails you could easily create one (or two) index
  39. discs (containing thumbnails), each index disc indexing many discs of
  40. pictures. Alternatively you could have one central index on hard disc and
  41. have all the original pictures on floppies, allowing you to get an idea of
  42. what pictures you want (from the thumbnails) without having to use the
  43. floppies until you actually want to load the picture.
  44.  
  45.  
  46. Running Thumbnail for the first time 
  47. ------------------------------------
  48.  
  49. The first time you run Thumbnail it is important to configure it to run
  50. correctly. The most important thing to do is 'teach' it where to find
  51. ChangeFSI (so that in future ChangeFSI does not have to be 'seen' by the
  52. filer). To do this simply drag the ChangeFSI application to Thumbnail's icon
  53. on the iconbar.
  54.  
  55. Next you need to set up a few preferences, to do this select 'Config' from
  56. Thumbnail's main menu.
  57.  
  58.  
  59. Configuration
  60. -------------
  61.  
  62. The Configure window contains several options :
  63.  
  64.  
  65.   Max Size - defines the maximum size for the thumbnail pictures. This can
  66.              be anything from 15x15 to 80x80 pixels.
  67.              
  68.   Max 
  69.   Display 
  70.   Width    - This defines the number of thumbnail pictures that will be
  71.              placed across a row of a display window.
  72.              
  73.   Open
  74.   Root     - When set the root directory is opened as soon as you run the
  75.              application, otherwise you will need to click SELECT on the icon
  76.              bar icon to see the root directory.
  77.              
  78.   New
  79.   ChangeFSI- Versions of ChangeFSI 0.95 and later can handle output to
  80.              32bpp sprites. Using these makes the process of producing
  81.              thumbnails faster. Thus if you have a new version (0.95 or
  82.              later) set this option.
  83.              
  84.              However using this option can require a lot of disc space
  85.              (in !Scrap) for a temporary file during processing. Not
  86.              setting this option reduces disc space needed to approx. 1/4.
  87.              
  88.   Slides   - There are two different display types available within directory
  89.              viewers. The default is a display similar to the standard
  90.              RISC OS filer. Setting this option changes the display to
  91.              appear like a collection of photograph slides.
  92.              
  93.   Full
  94.   Scroll   - By default display windows only have a vertical scroll bar
  95.              but setting this option marked them have both scroll bars.
  96.              
  97.   Auto
  98.   Display  - This option makes Thumbnail automatically set the display
  99.              option (see below) according to the current mode. This means
  100.              that in modes of 16 or less colours a 16 colour sprite will
  101.              be created for display, in 256 colour modes a 256 colour
  102.              sprite will be created, and in 16bpp and 32bpp modes a 32K
  103.              colour sprite will be created.
  104.              
  105.   Auto
  106.   Update   - Automatic update of scan file (see below).
  107.   
  108.   Update
  109.   Path     - If this option is set then when ever you try to create a
  110.              thumbnail which already exists in the thumbnail directory,
  111.              then only information (path, file size, etc.) will be
  112.              updated. If not set then the thumbnail will be recreated.
  113.              Thus by setting this option you can easily and quickly
  114.              keep your thumbnail collection up to date by simply dragging
  115.              directories to Thumbnail and it will only process fully those
  116.              that are new.
  117.              
  118.   Bell     - When set Thumbnail will beep when it has finished processing
  119.              all thumbnails waiting.
  120.              
  121.   Relative
  122.   Path     - This option, when set, will make Thumbnail store (as well as
  123.              the full path to the original file) a relative path to the
  124.              original file. This means that if you move Thumbnail AND the
  125.              original files so they remain relatively in the same location
  126.              Thumbnail will still be able to locate the original files.
  127.              (See 'Relative Paths' section for more details).
  128.              
  129.   Display
  130.   Sprite   - This option dictates whether then a sprite file (in Thumbnail)
  131.              is ADJUST double clicked (to view it) the sprite file is simply
  132.              run (and thus usually passed to !Paint) or whether Thumbnail
  133.              should display the sprite itself. If selected Thumbnail will
  134.              display the sprite.
  135.              
  136.   Display  - You can set the display to be either 16, 256 or 32K colour.
  137.              This defines what type of sprite thumbnail should create
  138.              when displaying a thumbnail picture.
  139.              256 colour produces the best results (even when viewed in a 16
  140.              colour mode), but 16 colour will take up less memory.
  141.              The 32K colour option is only available on Risc PC machines
  142.              and will produce the best results in 16bpp and 32bpp modes.
  143.              
  144.   Storage  - This sets whether Thumbnail should store thumbnails (on disc)
  145.              as 16 bpp or 32 bpp data. The default is 16 bpp, and there isn't
  146.              any real reason to change this as setting 32 bpp will make
  147.              little difference to image display quality, but will make
  148.              the files twice as large.
  149.              
  150.              Under this you can also elect for thumbnails to be compressed
  151.              when stored, providing a good level of compression at little
  152.              extra cost (see below). Compression requires RISC OS 3.
  153.              Please note that compression can only be used when you have
  154.              selected 16 bpp storage.
  155.                           
  156.              
  157. When the settings are to your liking 'Save' the options to save the
  158. configuration so that the options take effect on future runs of Thumbnail, or
  159. select 'OK' to make the changes temporary.
  160.  
  161. Note: These settings can be changed at any time. However, changing the 'Max
  162. Size' setting only alters new thumbnails created after the setting has been
  163. changed; but the display setting makes no difference to the stored
  164. thumbnails, only the display versions.
  165.  
  166. Thumbnails created at 32 bpp can be later 'compressed' to 16 bpp using the
  167. 'Picture Information' window.
  168.  
  169.  
  170.  
  171. Thumbnail directories
  172. ---------------------
  173.  
  174. Thumbnail stores its thumbnail pictures within a directory structure within
  175. its own application directory. To view the top level directory (called
  176. 'Thumbnail:$') simply click SELECT on the Thumbnail icon on the iconbar.
  177.  
  178. This directory viewer (which is NOT a filer viewer, although it is similar in
  179. some respects) is initially empty. In this directory you can place either
  180. further directories and/or thumbnail pictures.
  181.  
  182.  
  183.  
  184. Creating a directory
  185. --------------------
  186.  
  187. To create a directory simply press MENU over the Thumbnail directory viewer
  188. you want to create the directory in. A menu will pop up containing a 'New
  189. Directory' submenu entry (among others) which works just like in the standard
  190. filer.
  191.  
  192.  
  193. Moving between directory viewers
  194. --------------------------------
  195.  
  196. This is performed in a similar way to the standard filer. Opening a viewer
  197. containing a large number of thumbnails can take a little while, as the
  198. thumbnail pictures will need to be read and dithered to the correct display
  199. type.
  200.  
  201. When you close a thumbnail viewer the memory taken up by the display sprites
  202. will be freed, thus reopening the directory will require the thumbnails to be
  203. read again.
  204.  
  205.  
  206. Creating a thumbnail picture
  207. ----------------------------
  208.  
  209. To create a thumbnail picture simply drag the picture file you want to use to
  210. any of the Thumbnail directory viewers. Thumbnail will then produce a
  211. thumbnail version of that picture and place it within that viewer. The
  212. thumbnail will be given the same file name as the original picture file
  213. (although you can change this later). The conversion process is done in two
  214. stages, each producing an hourglass, the first converting the picture from
  215. the original file format (GIF, JPEG, etc.) (using ChangeFSI) to a 32bpp
  216. sprite, and then the second is the rescaling of the 32bpp sprite to a 16bpp
  217. thumbnail version.
  218.  
  219. During processing an information window is displayed showing the filename of
  220. the current file being processed. This window also contains an icon marked
  221. 'Pause', selecting this will cause Thumbnail to pause processing (after
  222. finishing the current one) until you select the icon again.
  223.  
  224. You can drag multiple files to Thumbnail and also directories, and Thumbnail
  225. will queue all items dragged to it and process them in order.
  226.  
  227. If you drag a directory to a Thumbnail viewer then a directory will be
  228. created (if not already there) with the same name and all the contents of
  229. that directory (including further subdirectories) will have thumbnail
  230. pictures placed in the thumbnail directory.
  231.  
  232.  
  233. Is that it?
  234. -----------
  235.  
  236. Nope. Thumbnail provides a great deal more than simply providing a system for
  237. viewing thumbnail pictures within a directory structure. It also provides
  238. access to the original file, and the ability to add descriptions of the
  239. pictures and also search the pictures for those whose descriptions contain
  240. certain words.
  241.  
  242.  
  243. The Picture Information Window
  244. ------------------------------
  245.  
  246. If you double click (with SELECT) on any thumbnail picture you will be shown
  247. an information window about that picture. This window contains many things :
  248.  
  249.   Top left   - The thumbnail and thumbnail name (as in the directory viewer).
  250.   
  251.   Top centre - The size of the original picture in pixels, and an icon
  252.                (see below).
  253.                
  254.   Top Right  - 6 radio icons for selecting output type (see below).
  255.   
  256.   Centre     - The full path name of the original file.
  257.   
  258.   Below      - A writable icon marked 'Description' and information about
  259.                the thumbnail (size in pixels and bytes, and storage);
  260.                plus an icon marked 'Update'.
  261.                
  262.   Bottom     - Contains information about the thumbnail (size, number of
  263.                bites and whether it is 16 or 32 bpp).
  264.  
  265. The 'Update' icon updates the description stored with the thumbnail to match
  266. the description in the 'Description' icon.
  267.  
  268. The icon in the top centre allows you to easily drag the original file to
  269. another application without having to locate it in the directory structure.
  270. Also by setting the radio icons (top right) you can also get the file
  271. converted to a convenient format as well :
  272.  
  273.   As stored  - Transfers the file as is, in original GIF, JPEG or whatever.
  274.   256 Sprite - Converts to a standard 256 colour sprite (dithered)
  275.   32 bpp     - Converts to 32bpp sprite.
  276.   16 bpp     - Converts to 16bpp sprite
  277.   16 colour  - Converts to a dithered 16 colour sprite (you need to be in
  278.                a 16 colour mode).
  279.   256 grey   - Converts to a 256 grey scale sprite.
  280.   
  281.  
  282. Note: You can also transfer the original file in the 'As stored' state by
  283. simply dragging the directory viewer thumbnail picture to the relevant
  284. application.
  285.  
  286. The icon marked 'Compress', which  will be greyed out for 16 bpp thumbnails,
  287. will convert a 32 bpp thumbnail to a 16 bpp thumbnail.
  288.  
  289.  
  290. Viewing a picture in full
  291. -------------------------
  292.  
  293. If you double click on a thumbnail using ADJUST then Thumbnail will attempt
  294. to bring you a viewing of the picture in full.
  295.  
  296. The process Thumbnail uses is detailed here, although you don't need to
  297. understand the process. First thumbnail broadcasts a message (Data_Open) to
  298. all currently running tasks to see it they want to handle it. If none of the
  299. tasks accept the file then Thumbnail checks to see if a run action has been
  300. defined for that file type (via an Alias$@RunType variable). If is has then
  301. Thumbnail will act upon that variable. Finally if all else fails, Thumbnail
  302. will pass the picture (unless it is a Draw or ArtWorks file) to ChangeFSI
  303. (running it if it isn't already running) to display.
  304.  
  305.  
  306. Opening the directory which contains a picture file
  307. ---------------------------------------------------
  308.  
  309. If you want to open the directory viewer for the directory containing the
  310. original file for a given thumbnail picture, simply double click on the
  311. thumbnail picture using ADJUST whilst also holding down either ALT key.
  312.  
  313.  
  314. Renaming and Deleting
  315. ---------------------
  316.  
  317. Pressing MENU over a directory viewer thumbnail will cause a menu top pop up
  318. where one of the entries is a submenu with the name of the thumbnail (or
  319. directory). This contains options for getting the information window (same as
  320. double clicking), renaming and deleting the item.
  321.  
  322.  
  323. Moving or copying an item
  324. -------------------------
  325.  
  326. You can move or copy an item (either a thumbnail or a directory) by simply
  327. dragging it from one viewer window to another in the same way as the filer.
  328.  
  329. Thus plain dragging from one Thumbnail viewer to another will copy that item,
  330. while dragging while holding down SHIFT will move an item.
  331.  
  332. If you 'copy' a directory to a standard filer window then a slave Thumbnail
  333. application will be created in that directory (if one is not already present)
  334. and the directory (and contents) will be copied to the root directory of
  335. that slave application.
  336.  
  337.  
  338. Merging two Thumbnail applications
  339. ----------------------------------
  340.  
  341. If you have two Thumbnail applications and wish to merge the contents of one
  342. into the other you can perform this simply by double clicking on the
  343. Thumbnail application you wish to merge (this makes it the current Thumbnail
  344. application) and drag the directories in the root directory to the filer
  345. window containing the Thumbnail application you wish to merge with (the
  346. destination Thumbnail application).
  347.  
  348. The directories in the current Thumbnail application will now be copied to
  349. the destination Thumbnail application.
  350.  
  351.  
  352. Performing a Scan
  353. -----------------
  354.  
  355. Both the main menu and the directory viewer menus contain entries called
  356. 'Scan'. This builds up a special file (used in searches) which contains
  357. information about all the thumbnails. After the scan you are presented with a
  358. window detailing how many files and directories you have and the total size
  359. of all the thumbnails stored.
  360.  
  361.  
  362. Automatic Update of Scan file
  363. -----------------------------
  364.  
  365. If you set the 'Auto Update' icon in the configuration then the scan file will
  366. be automatically updated by Thumbnail each time you perform any operation
  367. which would otherwise have made the scan file out of date. The only
  368. disadvantage of setting this option is that with a large scan file on a slow
  369. device updating may take time, thus the option is not set by default.
  370.  
  371. With automatic updating you should, if starting with an upto date scan file,
  372. not need to perform future scans unless you make alterations to the thumbnail
  373. data file from outside Thumbnail (see below).
  374.  
  375.  
  376. Performing a Search
  377. -------------------
  378.  
  379. The 'Search' window is reached by selecting the 'Search' option on the menus.
  380. This window contains a writable icon for entering the search string, an
  381. option for making the search ignore case and also a message stating how upto
  382. date the 'Scan' file is. If it is out of date you really need to perform a
  383. scan before doing a search, as an out of date scan file will not produce a
  384. completely correct search.
  385.  
  386. When you perform a search the scan file will be scanned and a special
  387. directory viewer will be displayed containing thumbnails of those that match
  388. the search. The search viewer is similar to the standard directory viewer but
  389. limited in that you can't bring up a menu on that window, nor drag files to
  390. it; however you can bring up the information window on any of the thumbnails.
  391.  
  392. You can not perform a null search. Entering a special search string of '¤'
  393. (or '¬' on a Risc PC) will search out all the thumbnails which have a null
  394. description (according to the Scan file).
  395.  
  396. There are also options for including the filename of the thumbnail in the
  397. search (ie. treat the filename as part of the description) and also an option
  398. for splitting the search string into words and searching for the words
  399. separately in the description.
  400.  
  401. With this last option you can also specify (in the icon marked 'Match') how
  402. many of the words need to be located for the search to work. The default is
  403. '1', thus if any words match then the thumbnail will be placed in the result
  404. window, with '2' two words must be in the description, etc.
  405.  
  406.  
  407. Draw Files
  408. ----------
  409.  
  410. As an added bonus Thumbnail is able to produce thumbnail pictures for many
  411. draw files as well as all the formats handled by ChangeFSI. There are a few
  412. limitations however. First the size information (in the picture information
  413. window) is fairly meaningless. Also when transferring the draw file (using the
  414. information window) with anything other than 'As stored' selected it will be
  415. converted to the relevant sprite but scaled to a maximum of 400x400 pixels
  416. (it is this size that appears in the size icon in the information window).
  417.  
  418. Please note that draw files saved under !Draw in RISC OS 2 will not work in
  419. Thumbnail (as the file will not contain the information needed to work out
  420. how to scale the picture). To solve this problem load the draw file into
  421. !Draw under RISC OS 3 (or later) and resave the file.
  422.  
  423. The above (concerning draw files created under RISC OS 2) does not apply if
  424. you have a copy of Acorn's 'DrawFile' module (inside your !System modules
  425. directory). If you have this file Thumbnail will use it instead of its own
  426. routines (which also means processing will be faster).
  427.  
  428.  
  429.  
  430. ArtWorks Files
  431. --------------
  432.  
  433. Thumbnail handles ArtWorks files in a similar way to Draw files, and again the
  434. 'size' information is meaningless. Also with ArtWorks files a little care
  435. needs to be taken when creating the thumbnails due to the ArtWorks renderer.
  436.  
  437. You can only create ArtWorks thumbnails when you are in any mode.
  438. Ideally, however, you should be in a 256 colour mode as this will usually
  439. produce better thumbnails.
  440.  
  441. If you do create thumbnails of ArtWorks files in a 16 (or less) colour mode
  442. you may notice the screen colours change for a short while during the
  443. rendering of the ArtWorks file, this is quite normal (and is needed to fool
  444. the renderer). It is not advised to create thumbnails of ArtWorks files in a
  445. mode with fewer then 16 colours.
  446.  
  447. On a Risc PC the best results will be obtained by creating the thumbnails
  448. whilst in a 16bpp or 32bpp mode (32 thousand or 16 million colour modes).
  449.  
  450.  
  451.  
  452. Replay Files
  453. ------------
  454.  
  455. Thumbnail has support for Replay files, whereby the initial title sprite is
  456. used for creating the thumbnail picture. 
  457.  
  458. In order to create a thumbnail for a Replay movie file, Thumbnail needs
  459. access to the 'extract' tool which is stored in the !ARMovie application. As
  460. long as this application has been 'seen' by the filer, Thumbnail will be able
  461. to locate the necessary tool.
  462.  
  463. Double clicking on ADJUST for a replay thumbnail will run the replay movie as
  464. if the file itself was double clicked (as with other file types). Using the
  465. information window to perform a conversion (eg. to 256 colour sprite) will
  466. cause the title sprite to be used in the conversion.
  467.  
  468.  
  469.  
  470. ProCAD & CADet Files
  471. --------------------
  472.  
  473. Thumbnail supports files from Minerva's CAD products (ProCAD and CADet) in a
  474. similar way to ArtWorks and Draw files (see above). As with Draw & ArtWorks
  475. files, the size information is fairly meaningless.
  476.  
  477.  
  478.  
  479. Squashed files
  480. --------------
  481.  
  482. Thumbnail has limited support for files which have been compressed using
  483. Acorn's !Squash utility. Any squashed files dragged to a Thumbnail directory
  484. viewer will be processed correctly and a thumbnail created.
  485.  
  486.  
  487.  
  488. Compression
  489. -----------
  490.  
  491. The compression of thumbnails for storage is provided by the Squash module
  492. within RISC OS 3, and can give between 50 and 75% saving on disc storage (but
  493. does require a more memory when loading thumbnails).
  494.  
  495. The icon marked 'Compress' on the picture information window will compress a
  496. thumbnail (storage) by making sure it is at 16 bpp (as opposed to 32 bpp) and
  497. also compress the thumbnail, but only if the 'Compress' option is selected in
  498. the configuration.
  499.  
  500.  
  501. Thumbnail and SparkFS
  502. ---------------------
  503.  
  504. There is a problem which can occur with pictures stored in archives under
  505. SparkFS (and possible other compression schemes). Sometimes Thumbnail will
  506. produce an error when trying to produce a thumbnail of a picture stored under
  507. such a compression scheme (eg. 'ChangeFSI failed to load ....'). This error
  508. is often produced because ChangeFSI claims all available memory during
  509. processing leaving none available for the compression filling system.
  510.  
  511. To overcome this problem you need to make sure the compression system has
  512. enough memory available to it before producing the thumbnail. With SparkFS
  513. you do this by configuring its minimum memory allocation such that it is
  514. large enough.
  515.  
  516.  
  517. Thumbnail Slave Applications 
  518. ----------------------------
  519.  
  520. With a very large collection of pictures and clip art, it may be that you
  521. wish to store thumbnail viewers in separate locations (some on floppy discs,
  522. some on hard discs, etc.).
  523.  
  524. Rather than duplicate the complete !Thumbnail application for each copy
  525. (which would take up about 300k) you can create a 'Thumbnail Slave
  526. Application' which takes up just over 1k of space. Then, as long as the main
  527. Thumbnail application is either running or has been 'seen' you can use this
  528. slave version as if it was a full version.
  529.  
  530. To create a slave application, simply select the 'Slave' option from the main
  531. menu. A window will pop up containing an icon which you should drag to the
  532. directory in which you wish to install the slave application, and the slave
  533. will be created.
  534.  
  535. Note: All slave applications must be called '!Thumbnail', and only one
  536. thumbnail application (either real or slave) can be active at one time. If you
  537. double click on an application another is running then the one you are
  538. looking at will be closed down, and the new one will be used.
  539.  
  540.  
  541. Relative Paths
  542. --------------
  543.  
  544. If you select the 'Relative Path' option on the configuration window then
  545. Thumbnail will store extra information with the thumbnails. This information
  546. details the location of the original file relative to the thumbnail
  547. application directory (or slave application directory if appropriate).
  548.  
  549. This means that if you move both the thumbnail application and the original
  550. files so that they remain relatively in the same location, Thumbnail will
  551. still be able to locate the original files.
  552.  
  553. Where relative paths are available, Thumbnail will use the relative path in
  554. preference to the absolute path (which is always stored) if the file can be
  555. accessed by that path, otherwise it defaults to the absolute path.
  556.  
  557. This means that if you move just the Thumbnail application it will also still
  558. be able to locate the original files.
  559.  
  560.  
  561. Thumbnail Correction
  562. --------------------
  563.  
  564. Sometimes you will get a thumbnail that is difficult to see, for example it
  565. may be too dark, too bright, etc. Thumbnail allows you to make small
  566. corrections to individual thumbnails.
  567.  
  568. To correct a thumbnail open the Picture Information window on that thumbnail
  569. picture (double click SELECT on the thumbnail picture). Using the window
  570. toggle icon (top right) make the information window full sized. At the bottom
  571. of the window will now be a line :
  572.  
  573.                         _____                    _____
  574.    Correction :  Add : |_____|       Multiply : |_____|       Try
  575.    
  576.  
  577. The 'Add' icon will (by default) contain the value 0, the 'Multiply' icon
  578. will contain 1.
  579.  
  580. By altering the values you will make Thumbnail perform an extra process when
  581. producing the display thumbnail picture.
  582.  
  583. Both operations work on the intensity of the picture, multiply will multiply
  584. the pixel intensity by a constant, and add will add a constant value to the
  585. intensity of the pixels.
  586.  
  587. For example to brighten a picture place a positive value in the 'Add' icon,
  588. to darken place a negative value in the 'Add' icon. The 'Add' icon must
  589. contain a whole number between -256 and 256 (typically a value between -64
  590. and 64 will be useful, values outside this range will usually be fairly
  591. useless).
  592.  
  593. To increase the contrast of a picture place a value >1 in the 'Multiply'
  594. icon, a value between 0 and 1 will reduce the contrast. The value in the
  595. 'Multiply' icon is a real number between 0 and (about) 4 (although the is no
  596. set limit). Typically values between 0.5 and 2 will be useful.
  597.  
  598. Gamma correction can be achieved by using a negative multiply value. In this
  599. case the multiply value is made positive, and then used as the input to the
  600. gamma correction function. Gamma correction performs a nonlinear brightening
  601. operation. A gamma value of 1 (-1 placed in the multiply icon) produces no
  602. change, values above 1 tend to brighten, values below 1 darken.
  603.  
  604. As a guide, for thumbnails that are too dark try the following values in the
  605. 'Multiply' icon : -1.5, -2, -2.5 (these will brighten with increasing
  606. effect).
  607.  
  608. You can combine add and multiply operations, in which case Thumbnail will
  609. perform the multiply then the add.
  610.  
  611. To see the results of changing the values select the 'Try' icon. Thumbnail
  612. will then reprocess the thumbnail picture and display the result in the
  613. display icon at the top left of the information window.
  614.  
  615. Once you are happy with the display, select the 'Update' icon and your
  616. settings will be saved with the thumbnail for future use.
  617.  
  618. Entering values in the add and multiply icons won't alter the stored
  619. thumbnail data in any way, it only alters how that data is handled when
  620. Thumbnail creates a display sprite. Thus you can not damage a thumbnail
  621. permanently by trying out values.
  622.  
  623. NOTE: When trying out different values for the add and multiply icons make
  624. sure that you have not altered the 'Display' setting in the configuration
  625. window (or changed mode with 'Auto Display' set) as this will confuse
  626. Thumbnail and may cause it to crash.
  627.  
  628.  
  629. Thumbnail on a Risc PC
  630. ----------------------
  631.  
  632. Thumbnail will work perfectly well on a Risc PC, although there is one minor
  633. problem associated with the '32k colour' display option. With this option set
  634. (or the 'Auto Display' option set where display thumbnails are created in
  635. either a 32 thousand or 16 million colour mode) the thumbnails will not
  636. appear if you are in a 256 (or less) colour mode. This would appear to be a
  637. problem with RISC OS 3.5 and may be resolved in future OS releases.
  638.  
  639. In the mean time if you are using a 256 (or less) colour mode you should not
  640. set the '32k colour' option. The best option is to set the 'Auto Display'
  641. option (which will pick the best option for the current mode), but if you
  642. subsequently change mode you may need to close the Thumbnail display windows
  643. and reopen them again in order to see the thumbnails.
  644.  
  645. Thumbnail uses the new display sprite for signifying that a directory is
  646. open. On pre Risc PC machines you can use this effect by defining a sprite
  647. called 'directory' and placing it in the WIMP sprite pool.
  648.  
  649.  
  650. Thumbnail with long filenames
  651. -----------------------------
  652.  
  653. Thumbnail now has limited support for files with longer filenames that are
  654. currently supported by ADFS (eg. users of !LongFiles). Internally Thumbnail
  655. does not support filenames longer than 10 characters (ie. thumbnail file
  656. names can not be longer than 10 characters) however the source files can now
  657. be longer than 10 characters (Thumbnail will truncate the file name when
  658. creating the thumbnail picture).
  659.  
  660.  
  661. General Notes & Tips
  662. --------------------
  663.  
  664. Note that when adding items to a directory they will initially be placed at
  665. the end of the directory viewer (at the bottom). However in future viewings
  666. the directory will be in alphabetical order.
  667.  
  668. When you delete an item from a directory its icons will be greyed out whilst
  669. that directory viewer is on screen.
  670.  
  671.  
  672. As to what size you should make thumbnail pictures, this is something that
  673. needs some consideration. The bigger the thumbnails the more detail of the
  674. original picture they can contain, but they also take more storage space, and
  675. more memory to store whilst being displayed.
  676.  
  677. To give an indication of likely storage costs, consider the following
  678. examples of two example files converted to thumbnails of differing sizes
  679. using 16bpp compressed storage :
  680.  
  681.  
  682.       Size set        Picture1        Picture2
  683.       
  684.       80 x 80         4179            2742
  685.       
  686.       64 x 64         3036            2009
  687.       
  688.       48 x 48         1814            1426
  689.       
  690.       32 x 32         1033             819
  691.       
  692.  
  693. The 'Size set' shows the size configured as the maximum size, and the file
  694. sizes are in bytes. Picture1 is a GIF file, Picture2 a draw file.
  695.  
  696. As can be seen a jump from 32x32 to 80x80 (a 6.25 times jump in area) results
  697. in just a 4 times jump for picture1 and a 3.33 jump for picture2.
  698.  
  699. For reference, the uncompressed size for an 80x80 Picture1 is 10662 bytes
  700. (for 16 bpp).
  701.  
  702. Because Thumbnail has its own directory structure for storing the thumbnail
  703. pictures, the directory structure does not need to map that of your storage
  704. of the actual pictures. Indeed thumbnails in the same Thumbnail directory
  705. viewer could relate to pictures on different discs.
  706.  
  707. JPEG loading is handled by software from the 'Independent JPEG Group's  JPEG
  708. software' which has been altered to provide support for Thumbnail's own use.
  709.  
  710.  
  711. Thumbnail Structure
  712. -------------------
  713.  
  714. The thumbnail directory structure is contained in a standard RISC OS
  715. directory structure within the application directory. The directory structure
  716. starts in a directory called 'Root'. This means that if you need to perform
  717. any operations on any of the stored thumbnails, etc (for example a file
  718. exists in a thumbnail directory that crashed the application) you can perform
  719. the operation using the standard RISC OS filer.
  720.  
  721.  
  722. User Licence
  723. ------------
  724.  
  725. Thumbnail version 1.50, © copyright Ian Palmer 1994, 1995, 1996, 1997.
  726.  
  727. ArtWorks Rendering Modules © Computer Concepts Ltd.
  728.  
  729. ProCAD/CADet Rendering Modules © Minerva Software Ltd.
  730.  
  731. The term 'program' refers to the executable and all associated data
  732. (excluding the ArtWorks Rendering Modules and ProCAD/CADet Rendering Modules).
  733.  
  734. The author reserves the right to take action against any person, or company,
  735. that acts in such a way as to break the terms specified in this user licence.
  736.  
  737. This program is supplied 'as is', without express or implied warranty.
  738. No representations are made about the suitability of this software for
  739. any purpose. The author can not accept liability for any loss or damage
  740. resulting from the use of this program.
  741.  
  742. All rights reserved.
  743.  
  744.  
  745.                                  Distribution
  746.                                  ------------
  747.                                  
  748. This version of the program may be freely distributed, subject to the terms
  749. below. This permission to distribute only applies to the version stated
  750. above, and may be withdrawn at any time.
  751.  
  752. Terms of distribution :
  753.  
  754.   1. The program must be distributed intact, including this (and all other)
  755.      copyright message(s).
  756.      
  757.   2. The program can only be distributed in such a way that no commercial
  758.      gain, or advantage, is made thorough its distribution. Distribution
  759.      'costs' may be charged, insofar that these charges are reasonable.
  760.      
  761.   3. The program must NOT be supplied with, or part of, a commercial package
  762.      without the express permission of the author. 
  763.      
  764.   4. The program must NOT distributed with thumbnail pictures contained
  765.      within the application. Thumbnail pictures can only be distributed
  766.      within slave Thumbnail applications or 'Read-Only' versions (with
  767.      permission).
  768.      
  769.   5. The author reserves the right to refuse any individual, or company,
  770.      permission to distribute this program.
  771.      
  772.      
  773.  
  774.                                     Use
  775.                                     ---
  776.                                     
  777. Permission is hereby granted to allow any person, group, body, or company to
  778. use this program, subject to the following terms :
  779.  
  780.  
  781.   1. The program is supplied "as is", without express or implied warranty.
  782.      No representations are made about the suitability of this software for
  783.      any purpose.
  784.           
  785.   2. The author reserves the right to refuse any person, or company,
  786.      permission to use this program.
  787.      
  788.      
  789.                              Acknowledgements
  790.                              ----------------
  791.  
  792. JPEG loading is handled by software from the 'Independent JPEG Group's  
  793. JPEG software' which has been altered to provide support for Thumbnail's
  794. own use.
  795.  
  796. TIFF Loading uses libtiff:
  797.  * Copyright (c) 1988, 1989, 1990, 1991 Sam Leffler
  798.  * Copyright (c) 1991 Silicon Graphics, Inc.
  799.  *
  800.  * Permission to use, copy, modify, distribute, and sell this software and 
  801.  * its documentation for any purpose is hereby granted without fee, provided
  802.  * that (i) the above copyright notices and this permission notice appear in
  803.  * all copies of the software and related documentation, and (ii) the names of
  804.  * Sam Leffler and Silicon Graphics may not be used in any advertising or
  805.  * publicity relating to the software without the specific, prior written
  806.  * permission of Sam Leffler and Silicon Graphics.
  807.  
  808.                  
  809.                         ArtWorks Rendering Modules
  810.                         --------------------------
  811.                         
  812. The ArtWorks rendering modules supplied with this program are copyright
  813. Computer Concepts Ltd. They must not be incorporated in any other programs
  814. without the permission of Computer Concepts Ltd.
  815.  
  816. The modules are distributed with Thumbnail with the kind permission of
  817. Computer Concepts Ltd.
  818.      
  819.  
  820.                       ProCAD/CADet Rendering Modules
  821.                       ------------------------------
  822.                         
  823. The ProCAD and CADet rendering modules supplied with this program are copyright
  824. Minerva Software Ltd. They must not be incorporated in any other programs
  825. without the permission of Minerva Software Ltd.
  826.  
  827. The modules are distributed with Thumbnail with the kind permission of
  828. Minerva Software Ltd.
  829.  
  830.  
  831.